home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audio / alGetChannels.z / alGetChannels
Encoding:
Text File  |  1998-10-20  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaallllGGGGeeeettttCCCChhhhaaaannnnnnnneeeellllssss((((3333ddddmmmm))))                                          aaaallllGGGGeeeettttCCCChhhhaaaannnnnnnneeeellllssss((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      alGetChannels, alSetChannels - get/set the channel setting in an audio
  10.      AAAALLLLccccoooonnnnffffiiiigggg
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  14.  
  15.      iiiinnnntttt aaaallllGGGGeeeettttCCCChhhhaaaannnnnnnneeeellllssss((((AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg))))
  16.      iiiinnnntttt aaaallllSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllssss((((AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg,,,, iiiinnnntttt cccchhhhaaaannnnnnnneeeellllssss))))
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  19.      _c_o_n_f_i_g     expects an AAAALLLLccccoooonnnnffffiiiigggg structure, the returned value of
  20.                 aaaallllNNNNeeeewwwwCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))) or aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))).
  21.  
  22.      _c_h_a_n_n_e_l_s   expects a int value indicating the number of samples per
  23.                 sample frame, i.e. the number of channels.
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      aaaallllGGGGeeeettttCCCChhhhaaaannnnnnnneeeellllssss returns the of number of samples per frame in the given
  27.      _c_o_n_f_i_g.
  28.  
  29.      aaaallllSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllssss sets the channel setting in an AAAALLLLccccoooonnnnffffiiiigggg structure.  All
  30.      ports that you attempt to open with this AAAALLLLccccoooonnnnffffiiiigggg structure will try to
  31.      use the channel setting that you specify in _c_h_a_n_n_e_l_s.
  32.  
  33. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  34.      Upon successful completion, aaaallllGGGGeeeettttCCCChhhhaaaannnnnnnneeeellllssss returns a number greater than
  35.      0. Otherwise, aaaallllGGGGeeeettttCCCChhhhaaaannnnnnnneeeellllssss returns -1 and sets an error number which can
  36.      be retrieved using oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  37.  
  38.      aaaallllSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllssss returns 0 when successfully called. Otherwise,
  39.      aaaallllSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllssss returns -1 and sets an error number which can be retrieved
  40.      using oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  41.  
  42.      Either function can fail for the following reason:
  43.  
  44.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG   _c_o_n_f_i_g is either invalid or null.
  45.  
  46.      In addition, aaaallllSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllssss can fail for the following reasons:
  47.  
  48.      AAAALLLL____BBBBAAAADDDD____CCCCHHHHAAAANNNNNNNNEEEELLLLSSSS
  49.           _c_h_a_n_n_e_l_s is invalid. Note that aaaallllSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllssss may succeed even if a
  50.           bad value for _c_h_a_n_n_e_l_s is given; however, in this case, the ensuing
  51.           aaaallllOOOOppppeeeennnnPPPPoooorrrrtttt call will fail and set an error of AL_BAD_CHANNELS.
  52.  
  53. NNNNOOOOTTTTEEEE
  54.      aaaallllSSSSeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))) will not change the channel setting.  An application
  55.      cannot change the channel setting of an AAAALLLLppppoooorrrrtttt after it has been opened.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaallllGGGGeeeettttCCCChhhhaaaannnnnnnneeeellllssss((((3333ddddmmmm))))                                          aaaallllGGGGeeeettttCCCChhhhaaaannnnnnnneeeellllssss((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74. SEE ALSO
  75.      alNewConfig(3dm), alOpenPort(3dm), alGetConfig(3dm), alWriteFrames(3dm),
  76.      alReadFrames(3dm), oserror(3C)
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.